home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / util / boot / sdate10.lha / StartupDate.txt < prev    next >
Text File  |  1999-01-31  |  9KB  |  238 lines
  1.                        StartupDate Version 1.0
  2.                        -----------------------
  3.  
  4. 1.1 Copyright
  5. 1.2 Disclaimer
  6. 1.3 Distribution
  7.  
  8. 2.1 Introduction
  9.  
  10. 3.1 System Requirements
  11. 3.2 Installation
  12.  
  13. 4.1 Useage
  14.  
  15. 5.1 Bug Report
  16. 5.2 1.3 Users
  17.  
  18. 6.1 Contact E-Mail Address
  19.  
  20.  
  21. 1.1 - Copyright
  22. ---------------
  23.  
  24. This guide file, the supplied document file and the supplied executable file 
  25. are all now relased as open source. You may modify the program and
  26. documentation as you see fit - I claim now copyright on it. The source code
  27. is available in the same aminet directory as this file but with the name
  28. sdate10_src.lha.  
  29.  
  30.  
  31. 1.2 - Disclaimer
  32. ----------------
  33.  
  34. This software and information is provided "as is". No warranties are made 
  35. either expressed or implied with respect to the accuracy, reliability, 
  36. performance, currentness, or operation of this software and information and 
  37. all useage is at your own risk. The author does not assume any 
  38. responsibility or liability whatsoever with respect to your use of this 
  39. software and information.
  40.  
  41. Basically if this software goes wrong and does anything bad then I cannot be 
  42. held responsible. Not that anything bad should happen. If you have found a 
  43. serious bug then please let me know.
  44.  
  45. 1.3 - Distribution
  46. ------------------
  47.  
  48. This program and supplied files can be freely distributed. There are no
  49. conditions of distribution. You may modify the program as you see fit
  50. using the source code in the archive sdate10_src.lha. You can release
  51. this software as your own if you wish, although I would apreciate a
  52. metion in the documentation.
  53.  
  54. 2.1 - Introduction
  55. ------------------
  56.  
  57. This program was written because I became fed up with my files not having 
  58. the correct date and time on them. My Amiga 1200 does not have a battery 
  59. backed clock so I decided to write this program. It enables you to set the 
  60. date and the time on startup. This is done using this program and the 
  61. AmigaDos® Date command. 
  62.  
  63. The idea for this feature came from MS-DOS® which automatically requests the 
  64. date and time if there is no clock present. 
  65.  
  66. I hope you like this program!
  67.  
  68.  
  69. 3.1 - System Requirements
  70. -------------------------
  71.  
  72. This program requires no special version of the operating system. It works 
  73. on Floppy Disk or Hard Disk.
  74.  
  75. The following files are needed in your C: directory :-
  76.  
  77. Version 2.04+ Users :-
  78.  
  79. Date
  80. Delete
  81. Execute
  82.  
  83. Version 1.3 or less users :-
  84.  
  85. Echo
  86. Date
  87. Delete
  88. Execute
  89.  
  90. If you wish to use the supplied Installer® script then you will need 
  91. installer. Any version should work. For more information see Installation.
  92.  
  93.  
  94. 3.2 - Installation
  95. ------------------
  96.  
  97. Please use the installation script provided in this archive. It requires the 
  98. installer program from Commodore (RIP) or Amiga Technologies / Escom. If you 
  99. get the message Unable to open your tool 'Installer' then you will need to 
  100. find the installer package. You will probably already have this on your 
  101. system. Check on your original Operating System disks as well as any 
  102. application software disks you have. It is usually stored in the C or 
  103. Utilities directory of your disks. These may not have icons, so remember to 
  104. Use Show... All Files from the Window menu on your Workbench (Workbench 2.0+ 
  105. Only). Copy this to your C directory or simply change the default tool of 
  106. the install icon to point to the location of Installer. See your Workbench 
  107. manual for information on Default Tools.
  108.  
  109. You should select a mode appropriate to your Amiga knowledge. Novice user is 
  110. completely automatic and will create an install log file. Amateur allows you 
  111. to select operations regarding log files and installing for real or 
  112. pretending to install. After that installation is again automatic. If you 
  113. select expert you must confirm at every stage of the installation procedure. 
  114. You MUST however select to install the main executable StartupDate or the 
  115. program will not work. 
  116.  
  117. The script does modify your User-Startup sequence file (which it creates if 
  118. you do not have one) so bare this in mind if you ever want to remove 
  119. StartupDate.
  120.  
  121. Should the installation procedure fail at any time check that you have 
  122. inserted the right disk, that the disk is not damaged in any way and that 
  123. there is enough room free on the disk. (StartupDate requires about 10K of 
  124. disk space). If problems persist then you will have to install manually. The 
  125. instructions for doing this are below:-
  126.  
  127. Manual Installation Instructions
  128.  
  129. 1. Copy the StartupDate program to the C directory of your boot disk.
  130. 2. Add the following lines to your user-startup file in the S directory of 
  131. your boot disk. :-
  132.      StartupDate
  133.      Execute ram:date.tmp
  134.      Delete >nil: ram:date.tmp
  135.      echo "Date set as:-"
  136.      Date
  137.  
  138.  
  139. 4.1 - Useage
  140. ------------                              
  141.  
  142. The program should be fairly self explanatory, however you should first be 
  143. prompted to enter the date. This is in the form of the AmigaDOS® Date 
  144. command. For example 15-Aug-97. The day must be numerical (A zero is not 
  145. necessary before the number if it is single digit). Then the month, which 
  146. uses the first three letters of the month, E.G. Jan, Feb, Mar etc. Case is 
  147. not important. The year is just the last two numbers of the current year. 
  148. The dashes between the numbers and months are necessary. Use the minus key 
  149. (right of the 0 on the main keyboard). Press return to enter the date.
  150.  
  151. Next you will be asked to enter the time. Enter the hour (in 24 hour 
  152. notation) then a colon (:) and then the minute. You can also optionally 
  153. enter the second, although don't forget that there will be a short delay 
  154. between you entering the time and this actually being set. Again a colon 
  155. should be used. 
  156.  
  157. WARNING : This program does not contain any error checking. All the error 
  158. checking is done by AmigaDos, therefore if an error occurs the date command 
  159. will inform you and not StartupDate. Therefore if an error occurs then the 
  160. Startup procedure will be aborted with an error message and you should 
  161. reboot. If errors persist then check you are using the correct syntax. If 
  162. problems persist than it may be a bug in this program. If this is the case 
  163. then please contact me.
  164.  
  165. 5.1 - Bug Report
  166. ----------------
  167.  
  168. Whilst every attempt has been made to ensure this software is bug free, 
  169. there may well still be some bugs in the code. If you find anything 
  170. happening which you do not think is supposed to then I would like to know 
  171. about it, so I can fix it! Please make sure that if you are reporting bugs, 
  172. that you have the program installed correctly and that you have read all the 
  173. supplied documentation. If you need more help you can E-Mail me at: -
  174.  
  175. Joncombe@yahoo.com
  176.  
  177. Please include all details of your system configuration and any programs
  178. you are running (in case of conflicts). I will try to reply to all 
  179. messages even if I cannot fix the problem.
  180.  
  181. 5.2 - 1.3 Users
  182. ---------------
  183.  
  184. StartupDate will work on your system. However installation can be harder 
  185. than on newer systems. All versions of the Amiga installer up to and 
  186. including 1.24 will work on your machine. However the updated Installer by 
  187. Amiga Technologies / Escom will not. This version is called 43.3. 
  188.  
  189. The file user-startup is not a standard part of Workbench 1.3 and was 
  190. introduced in Workbench 2.0. The StartupII file is similar to the user-
  191. startup file. However the install script for StartupDate was written with 
  192. 2.0+ users in mind. Therefore it expects a user-startup file to be present. 
  193. You will be prompted by the installer that some lines need to be added to 
  194. your startup-sequence. These are the files to load the user-startup file the 
  195. installer creates. The default location should be fine, but if you are in 
  196. doubt then you should check the detailed help file for this section. The 
  197. user-startup file will now be created. This should cause no problems and 
  198. should work fine, but you should note that this is not the standard way of 
  199. working under version 1.3
  200.  
  201. The line delete ram:date.tmp >nil: is added to your user-startup file. This 
  202. is so that under Workbench 2.0 or greater the message ram:date.tmp deleted 
  203. is not displayed. However this feature is not supported by Workbench 1.3. 
  204. This means that on booting up you will be asked to insert vo